package com.qiaofang.applet.common.base;

import org.springframework.data.domain.Example;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.domain.Sort;

import java.util.List;
import java.util.Optional;

/**
 * 基础服务层接口
 *
 * @param <T> 实体类
 * @param <ID> 主键
 */
public interface BaseService<T extends BaseDomain, ID> {

    /**
     * 排序查询
     *
     * @param sort
     * @return
     */
    Iterable<T> findAll(Sort sort);

    /**
     * 分页查询
     *
     * @param pageable
     * @return
     */
    Page<T> findAll(Pageable pageable);

    /**
     * 查询单个对象
     *
     * @param example
     * @param <S>
     * @return
     */
    <S extends T> Optional<S> findOne(Example<S> example);

    /**
     * 条件查询
     *
     * @param example
     * @param <S>
     * @return
     */
    <S extends T> Iterable<S> findAll(Example<S> example);

    /**
     * 条件查询+排序
     *
     * @param example
     * @param sort
     * @param <S>
     * @return
     */
    <S extends T> Iterable<S> findAll(Example<S> example, Sort sort);

    /**
     * 条件查询+分页
     *
     * @param example
     * @param pageable
     * @param <S>
     * @return
     */
    <S extends T> Page<S> findAll(Example<S> example, Pageable pageable);

    /**
     * 条件统计
     *
     * @param example
     * @param <S>
     * @return
     */
    <S extends T> long count(Example<S> example);

    /**
     * 判读是否存在
     *
     * @param example
     * @param <S>
     * @return
     */
    <S extends T> boolean exists(Example<S> example);

    /**
     * 保存
     *
     * @param entity
     * @param <S>
     * @return
     */
    <S extends T> S save(S entity);

    /**
     * 批量保存
     *
     * @param entities
     * @param <S>
     * @return
     */
    <S extends T> Iterable<S> saveAll(Iterable<S> entities);

    /**
     * 新增
     *
     * @param entity
     * @param <S>
     * @return
     */
    <S extends T> S insert(S entity);

    /**
     * 批量新增
     *
     * @param entities
     * @param <S>
     * @return
     */
    <S extends T> List<S> insert(Iterable<S> entities);

    /**
     * 根据主键查询
     *
     * @param id
     * @return
     */
    Optional<T> findById(ID id);

    /**
     * 判断主键对象是否存在
     *
     * @param id
     * @return
     */
    boolean existsById(ID id);

    /**
     * 根据主键集合查询
     *
     * @param ids
     * @return
     */
    Iterable<T> findAllById(Iterable<ID> ids);

    /**
     * 统计总数
     *
     * @return
     */
    long count();

    /**
     * 根据主键删除
     *
     * @param id
     */
    void deleteById(ID id);

    /**
     * 根据实体类删除（实际上也是根据主键删除）
     *
     * @param entity
     */
    void delete(T entity);

    /**
     * 批量删除
     *
     * @param entities
     */
    void deleteAll(Iterable<? extends T> entities);
}
